home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / comm / tlxlog31.zip / LOGGIT.DOC < prev    next >
Text File  |  1989-04-12  |  20KB  |  536 lines
  1.         LOGGIT -- TELIX USE FILE ANALYZER
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                         LOGGIT -- TELIX USE FILE ANALYZER
  10.                               (C) 1988 by Vic Baron
  11.                            Version 3.1 -- Apr 12, 1989
  12.         ____________________________________________________________
  13.  
  14.  
  15.  
  16.                                 TABLE OF CONTENTS
  17.  
  18.  
  19.         Overview...................................................1
  20.  
  21.         Command Line Options.......................................1
  22.  
  23.         Pathnames..................................................1
  24.  
  25.         Conventions................................................1
  26.  
  27.         Starting LOGGIT............................................2
  28.  
  29.         Selecting Date Range.......................................2
  30.  
  31.         Scan Criteria..............................................2
  32.  
  33.         Up/Download analysis.......................................3
  34.  
  35.         Output Modes...............................................3
  36.  
  37.         Batch Files................................................4
  38.  
  39.         Cautions...................................................4
  40.  
  41.         Shareware Concept..........................................5
  42.  
  43.         Appendix A.................................................6
  44.  
  45.         Appendix B.................................................7
  46.  
  47.         Appendix C.................................................8
  48.         LOGGIT -- TELIX USE FILE ANALYZER
  49.  
  50.  
  51.  
  52.  
  53.                                      LOGGIT
  54.  
  55.                              Telix Use Log Analyzer
  56.  
  57.  
  58.         OVERVIEW
  59.  
  60.         LOGGIT is a screen oriented, menu driven program that is designed
  61.         to provide an analysis of the Telix logfile. It will provide  the
  62.         user with several different analysis options and output.
  63.  
  64.  
  65.         COMMAND LINE OPTIONS
  66.  
  67.         The  only  command line option that LOGGIT supports is  /t  which
  68.         will disable the default file integrity check. It will,  however,
  69.         accept  input  from  a program such as Key-Fake.  Key-fake  or  a
  70.         similar  program may be used in a batch file to pass commands  to
  71.         LOGGIT thereby creating an automated analysis procedure.
  72.  
  73.         PATHNAMES
  74.  
  75.         LOGGIT  supports the standard DOS conventions for  pathnames  for
  76.         all  files  and may be run from any directory as long  as  it  is
  77.         included  in  your PATH. If a pathname is not specified  for  the
  78.         input and output files, the default is the current directory.
  79.  
  80.         CONVENTIONS
  81.  
  82.         When asking for input, as in a filename, LOGGIT will display  the
  83.         default value in  angle brackets <>. Thus, hitting return without
  84.         any input will use the data contained within the brackets.
  85.  
  86.         On  the occasions that a yes or no input is required LOGGIT  will
  87.         display  (y/N)  or (Y/n) indicating the default  value  in  upper
  88.         case.
  89.  
  90.         In  using the menus, the default value is the selection  that  is
  91.         highlighted  when  the menu is first presented.  Pressing  return
  92.         will  select  the  highlighted function.  The  selection  may  be
  93.         changed in two ways, either by using the cursor keys to highlight
  94.         another  selection  or  by entering the first  character  of  the
  95.         selection.
  96.  
  97.         Ctl-C  or  Ctl-Break will exit from any part of  LOGGIT  but  may
  98.         leave  incomplete files on the disk if the file output  mode  was
  99.         selected.
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.                                         1
  109.         LOGGIT -- TELIX USE FILE ANALYZER
  110.  
  111.  
  112.  
  113.  
  114.         STARTING LOGGIT
  115.  
  116.         Running LOGGIT is as simple as entering LOGGIT  at the DOS prompt
  117.         and  pressing <return>. You will then be presented with a  series
  118.         of menus which will define the input file and the scan  criteria.
  119.         At  the top center of the screen will be a message  window  which
  120.         will  prompt  you for the correct response. The menus  and  their
  121.         options  should  be  self explanatory  but  a  brief  description
  122.         follows:
  123.  
  124.         Enter Input filename <TELIX.USE>
  125.  
  126.         Hitting  <return>  at  this prompt will default  to  the  current
  127.         directory  and  the  TELIX.USE file.  For  any  other  selection,
  128.         maintained  in  the  format  of the  TELIX.USE  file,  enter  the
  129.         complete  pathname  of  the input file. Your  selection  will  be
  130.         displayed in the Input Window in the upper left of the screen.
  131.  
  132.         SELECTING DATE RANGE
  133.  
  134.         Next  is  displayed the menu which allows the  selection  of  the
  135.         range of dates upon which LOGGIT will operate.
  136.  
  137.         Alldates <default>-- compile data from the first date entered  in
  138.         the file to the last entry.
  139.  
  140.         Select dates -- allows the  selection of START and END dates as a
  141.         range  for compiling the data. LOGGIT will start  compiling  data
  142.         from the start date specified and will continue compiling data UP
  143.         TO but not including the END date. Dates are entered in the  form
  144.         MM-DD-YY.  To scan from a specified start date to the end of  the
  145.         file, you could enter any date that is beyond the end of the data
  146.         in the file. LOGGIT will continue to compile data until it reach-
  147.         es the end date or the end of the file.
  148.  
  149.         SCAN CRITERIA
  150.  
  151.         The  next  menu  presented tells LOGGIT whether  to  scan  for  a
  152.         specific BBS or to compile data on all calls made.
  153.  
  154.         Allcalls <default> -- compile data on all calls made. LOGGIT will
  155.         tally   all  calls,  keeping  track  of  time   online,   average
  156.         time/call,total calls to each number, total of uploads, downloads
  157.         and aborts. The output will be sorted by name and the  individual
  158.         results will be displayed as in appendix A.
  159.  
  160.         Individual  --  compile data on the specified  BBS.  LOGGIT  will
  161.         tally  all  calls  to  the specific BBS  keeping  track  of  time
  162.         online,total  calls,  average time/call, uploads,  downloads  and
  163.         aborts.
  164.  
  165.  
  166.  
  167.  
  168.  
  169.                                         2
  170.         LOGGIT -- TELIX USE FILE ANALYZER
  171.  
  172.  
  173.         UP/DOWNLOAD ANALYSIS
  174.  
  175.         If  the Individual mode has been selected, a submenu  of  choices
  176.         will appear allowing you to further define the analysis.
  177.  
  178.         Detailed  <default>  -- Compile the individual  up  and  download
  179.         activity  for  the  selected BBS,  showing  the  date,  protocol,
  180.         filename  and  transfer speed in CPS. A sample of the  output  is
  181.         shown in appendix B.
  182.  
  183.         Summary  --  Accumulate and display the totals for  the  selected
  184.         BBS.
  185.  
  186.         PcPursuit  --  Compensates for inaccuracy in Telix  logfile  when
  187.         accessing  PCP.  Use this mode for a more  accurate  time  online
  188.         calculation for your PCPursuit main number.
  189.  
  190.         OUTPUT MODES
  191.  
  192.         If  Allcalls or Individual Detailed has been selected,  the  next
  193.         menu presented is the output mode menu, allowing three  different
  194.         types of output.
  195.  
  196.         Screen <default> -- Sends all output to console. This is the only
  197.         output  mode  available  when using  the  Individual  Summary  or
  198.         Individual PcPursuit modes.
  199.  
  200.         Printer -- Sends all output to standard printer port.
  201.  
  202.         File -- Sends all output to data file.
  203.  
  204.  
  205.         If File is selected you are prompted for an output filename.
  206.  
  207.         Enter output filename <TELIX.RPT>
  208.  
  209.         Pressing <return> will use the default file TELIX.RPT or you  may
  210.         enter any valid DOS filename. LOGGIT will check for the existence
  211.         of the selected file and if present will allow you the option  to
  212.         overwrite the file.
  213.  
  214.         If the Individual mode has been selected, you are now prompted to
  215.         enter  the BBS name to analyze. The input is CASE  SENSITIVE  and
  216.         all  that need be entered is enough of the BBS name to  make  the
  217.         search unique. LOGGIT will attempt to locate the BBS name entered
  218.         and,  if  un